home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d23 / bbzipc.arc / ZIPPER.DOC < prev    next >
Encoding:
Text File  |  1989-02-07  |  9.8 KB  |  246 lines
  1.  
  2.  
  3.  
  4.      ZIPPER.DOC
  5.  
  6.  
  7.       
  8.                    ZIPPER.. by the Bytebrothers
  9.                            J.L. Pearson
  10.       
  11.       
  12.         Zipper is designed to let you easily and quickly convert
  13.      any and all .ARC and .PAK files to the to the new Phil Katz
  14.      ZIP format using PKZIP. Place ZIPPER in the directory that
  15.      you keep PAK.EXE, PKUNPAK.EXE and PKZIP.EXE in. ZIPPER will
  16.      automatically sense .ARC or .PAK formats and uncompress them
  17.      and convert them to Phil Katz's new .ZIP format. It operates
  18.      on one file at a time in automated fashion and deletes the
  19.      original file after verifying the unarchive operation.. The
  20.      original file date and time are preserved in the new .ZIP
  21.      file.
  22.       
  23.      Before you rush into conversion read the READ.ME file or the
  24.      note below on correctly installing the PAK.EXE program from
  25.      NoGate Technology.. It can be dangerous when run uninstalled.
  26.       
  27.       
  28.       
  29.      Here are some examples of usage..
  30.       
  31.      ZIPPER c:\arcs\*.pak
  32.       
  33.      this will convert all the .PAK files in directory C:\arcs
  34.      into .ARC files. The original .PAK files will be deleted so
  35.      when ZIPPER is done the .PAK's will be transformed into
  36.      .ZIPs.. If you have a number of .ARC's and .PAK's mixed in a
  37.      directory named C:\com the following commands can be used..
  38.       
  39.      ZIPPER c:\com
  40.       
  41.      this will change all the .PAK and .ARC files so that when
  42.      done directory c:\com will have nothing but .ZIP files..
  43.       
  44.      ZIPPER c:\com\*.arc
  45.       
  46.      this will change all the .ARC files to .ZIP but leave the
  47.      .PAK files intact.. C:\COM will have only .ZIP and .PAK files
  48.      in it..no .ARC's.
  49.       
  50.      Let's say you run a bbs and have a directory full of .ARC
  51.      files you want to change to .ZIP.. The directory name is
  52.      C:\bbs\dl1. Enter the following..
  53.       
  54.      ZIPPER c:\bbs\dl1
  55.       
  56.      ZIPPER will go to dl1 and since it is full of .ARC files it
  57.      will convert every one into a .ZIP file. Entering a directory
  58.      with no filenames is the same as \*.* and all files will be
  59.      converted. Notice that if the directory has both .ARC and
  60.      .PAK files they all will be converted to ZIP. Any .GIF, .MAC
  61.      or other extension files are always ignored..
  62.  
  63.  
  64.  
  65.      ZIPPER.DOC             Sunday, February 5, 1989 10:25 pm             Page 2
  66.  
  67.  
  68.       
  69.      If you have only one file to convert just enter the filename
  70.      as in ZIPPER c:\bbs\dl1\pascal.arc  The file PASCAL.ARC will
  71.      be converted to PASCAL.ZIP.. as simple as that..
  72.       
  73.      There is only one requirement for setup on ZIPPER. You must
  74.      set an environment variable SPAT to the path of your archive
  75.      utilities.. PKUNPAK.EXE, PAK.EXE and PKZIP.EXE.
  76.       
  77.      example.
  78.       
  79.      set spat=c:\utility
  80.       
  81.      will tell ZIPPER to look in directory C:\UTILITY for the
  82.      archving files. And to use this directory to store his config
  83.      file and the badfile list..
  84.       
  85.      This command can be placed in your autoexec.bat file and
  86.      ZIPPER will automatically be set up every time you boot..
  87.       
  88.      if you should get an error " out of environment space " when
  89.      you boot use the command..
  90.       
  91.      shell=command.com c:\ /e:1024 /p
  92.      Dos 3.3
  93.       
  94.      or
  95.      shell=c:\command.com /e:1024 /p
  96.      Dos 3.2
  97.       
  98.      in your CONFIG.SYS file.. using the drive that you boot from
  99.      and where your copy of command.com is located. This will
  100.      increase your environment area to 1k bytes but will not work
  101.      on early versions of DOS. Most later versions will accept
  102.      either command..
  103.       
  104.      ZIPPER will also use this path to create it's own
  105.      configuration file the first time you run it. You can modify
  106.      this file ZIPPER.CFG to reflect your unarchive command ( if
  107.      you have modified the commands in PAK.EXE ), the name you
  108.      want to call PKUNPAK ( ie. PKXARC etc.. ), and the actual
  109.      commands you send to PKZIP setting the level of compression.
  110.      Defaults are provided in the ZIPPER.CFG file for standard
  111.      operation at ZIP's highest compression level.. ZIPPER will
  112.      also use this directory to create a BADFILE.LOG file that
  113.      lists any and all .ARC or .PAK files that were bad and failed
  114.      to uncompress.. Make sure that you set PAK up right. Read the
  115.      notes in the READ.ME file or below under the heading
  116.      IMPORTANT on running the PAKINSTAL program on PAK.EXE.. He
  117.      can be dangerous if he is not installed correctly and you use
  118.      him outside of his home dir. With the SPAT variable set and
  119.      PAKINSTAL run on your copy of PAK.EXE ZIPPER will run from
  120.      any drive or directory as long as he is in your path..
  121.       
  122.       
  123.  
  124.  
  125.  
  126.      ZIPPER.DOC             Sunday, February 5, 1989 10:25 pm             Page 3
  127.  
  128.  
  129.       
  130.      operation..
  131.       
  132.      ZIPPER converts a file at a time and creates a .\SWORK
  133.      subdirectory under your current directory to work in. The
  134.      work directory is deleted when done..if there is an abort or
  135.      error during compression of an already unarced file the
  136.      program will prompt you, so if you want you can save the work
  137.      directory data.. The work directory will contain the last
  138.      unarced file's contents if a file has been unarced and not
  139.      repacked... Any errors encountered with bad arcs are handled
  140.      by inserting the time,date and pathname of the bad .ARC or
  141.      .PAK file into the file BADFILE.LOG and ZIPPER goes onto the
  142.      next file.. ZIPPER will abort cleanly if you press escape..
  143.       
  144.      ZIPPER saves the original date and time of the file and
  145.      touches the new .ZIP file, so the original file date is
  146.      preserved.. and you don't wind up with all your directory
  147.      files dated the day of the conversion..
  148.       
  149.      ZIPPER creates a file in your SPAT directory called
  150.      BADFILES.LOG. Everytime you run ZIPPER it places the time and
  151.      date of the run in the BADFILE.LOG file as well as any files
  152.      it finds which fail to unarchive.. here is a sample of the
  153.      file..
  154.       
  155.      ZIPPER badfiles Sunday February 5, 1989 time  8:40:26 p.m.
  156.      d:\arcs\hold\mona.pak
  157.      d:\arcs\hold\nc12.arc
  158.      d:\arcs\hold\nc13.arc
  159.      ZIPPER badfiles Sunday February 5, 1989 time  8:53:25 p.m.
  160.      d:\arcs\hold\mj12.pak
  161.      d:\arcs\hold\mono.arc
  162.      d:\arcs\hold\mj12.arc
  163.       
  164.      Registration of ZIPPER will give you a version that will
  165.      automatically delete all the bad files at the end of
  166.      operation.. and also has a batch switch to run without any
  167.      user intervention from a batch file.. I am not trying to
  168.      cripple ZIPPER but I am not going to hassle with any mods if
  169.      no one is interested in registering it..
  170.       
  171.       
  172.      Entering ZIPPER with no arguments will bring up a help screen
  173.      and then prompt you for a further filename.
  174.       
  175.       
  176.       
  177.      IMPORTANT:::::::::::::::::::::::::::::::::::::::::::::::::::
  178.       
  179.      PAK can be dangerous in that if you want to run it outside
  180.      the current directory you need to run a program called
  181.      PAKINST to install it and tell it where it's CNF file is
  182.      located. This install program is in the .PAK arc ( ie.
  183.      PAK151.ARC or PAK16.ARC ) but it's use is documented in the
  184.  
  185.  
  186.  
  187.      ZIPPER.DOC             Sunday, February 5, 1989 10:25 pm             Page 4
  188.  
  189.  
  190.      back of the docs and many people miss it. PAK can do some
  191.      very undesirable things if it is used outside it's home
  192.      directory without being installed.. Make sure and run PAKINST
  193.      and tell PAK where it's config file is before you use the set
  194.      command with ZIPPER and start using it outside of the PAK.EXE
  195.      directory..
  196.       
  197.      If you appreciate and use this program please send $15 for
  198.      registration to..
  199.       
  200.              FAST LOGIC OUTLAWS
  201.              J.L. Pearson
  202.              344 N. Acadia
  203.              Wichita Ks.
  204.              67212
  205.       
  206.      make all checks payable to J.L. Pearson..
  207.       
  208.      With registration you will be sent the latest revision of
  209.      ZIPPER which will have two command line switches.. One will
  210.      automatically delete all the bad arcs at the end of the
  211.      conversion.. the other switch will cause ZIPPER to run
  212.      without user prompts for automated operation from a batch
  213.      file..
  214.       
  215.      I will not be held responsible for any damage caused by this
  216.      program.. it is distributed as is. Care should be taken to
  217.      insure enough disk space to do the conversions. A tightly
  218.      packed floppy with PAK files can not have enough room to hold
  219.      the larger loosely compressed .ZIP files. The program will
  220.      abort when the disk is full and the last unarchived file will
  221.      be in the work directory.. The program has been tested on
  222.      many computers and if your computer will run PK and PAK and
  223.      you have correctly INSTALLED your PAK.EXE program you should
  224.      have no problems..
  225.       
  226.                              J.L. Pearson
  227.                              President and founder Bytebrothers
  228.                              Member Fast Logic Outlaws
  229.                              Wichita Ks.
  230.       
  231.      a note..
  232.       
  233.      We have all waited some time during the debacle between Phil
  234.      Katz's PKWARE vrs. SEA hassles. Phil has lost his PK code and
  235.      gone back to sqaure one while SEA's releases have found
  236.      remarkable new performance.. Phil has noted in his ZIP
  237.      release that the extension ZIP is released to the public
  238.      domain.. unlike SEA's attitude on ARC. I think this about
  239.      sums it up.. SEA now has the right to use ZIP on it's
  240.      tombstone and Phil can't complain let alone sue.. The worm
  241.      has turned folks..get Zippin.. ..R.I.P. ARC..!
  242.       
  243.                                              The Bytebrothers
  244.       
  245.  
  246.